home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / zcomd506.arc / ZCOMMDOC.AC < prev    next >
Text File  |  1991-05-06  |  71KB  |  1,771 lines
  1.  
  2.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  3.         ZCOMM User Manual                                                   61
  4.  
  5.         13.3  Kermit
  6.  
  7.         13.3.1  ZCOMM Kermit Capabilities At a Glance
  8.          Local operation..................Yes
  9.          Remote operation.................Yes
  10.          Transfers text files.............Yes
  11.          Transfers binary files...........Yes
  12.          Wildcard send....................Yes
  13.          Filename collision avoidance.....Yes
  14.          Can time out.....................Yes
  15.          8th-bit prefixing................Yes
  16.          8 bit serial data................Yes
  17.          Sliding Windows..................Yes
  18.          Long Packets.....................Yes
  19.          Repeat count prefixing...........Yes
  20.          Alternate block checks...........Yes
  21.          Terminal emulation...............Multiple
  22.          Communication settings...........Yes
  23.          Transmit BREAK...................Yes
  24.          IBM mainframe communication......Yes
  25.          Transaction logging..............Yes
  26.          Act as server....................no
  27.          Talk to server...................Yes
  28.          Advanced commands for servers....Yes
  29.          Handle file attributes...........no
  30.          Programmable reset string........Yes
  31.  
  32.         Kermit operates with a wide range of computer systems, including those
  33.         whose restrictive terminal interfaces prevent XMODEM transfers.
  34.         Kermit uses an encoding technique called quoting to represent control
  35.         characters and (if necessary) parity bits with standard printable
  36.         characters.  It is one of the few asynchronous error correcting
  37.         protocols that work properly with half duplex IBM front ends.  Because
  38.         of the overhead from character quoting, Kermit is less efficient
  39.         (slower) than ZMODEM.
  40.  
  41.         Kermit can transfer one or more files per command, preserving the
  42.         exact file length.
  43.  
  44.  
  45.         EXAMPLE: kermit sb file1 file2
  46.  
  47.  
  48.         EXAMPLE: kermit rb
  49.  
  50.  
  51.         13.3.2  Incompatible Kermit Dialects  When sending files with the
  52.         Kermit Protocol, ZCOMM uses all 8 bits for the transfer unless a 7 bit
  53.         parity mode (e.g., ena -7e) is used, the kermit 7 numeric parameter is
  54.         non zero, or the other program requests 8th bit qouting.  If ZCOMM is
  55.         using a 7 bit parity mode (such as ena -7m), ZCOMM requests 8th bit
  56.  
  57.  
  58.         (C) 1990 Omen Tech Inc              Chapter 13 Protocol File Transfers
  59.  
  60.  
  61.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  62.         ZCOMM User Manual                                                   62
  63.  
  64.         quoting unless the kermit 8 numeric parameter is non zero.
  65.  
  66.         -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  67.                         Both programs must use the same parity
  68.                         for Kermit file transfers to succeed.
  69.         -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  70.  
  71.         Kermit does not provide an automatic means of forcing both the sender
  72.         and receiver to use the same dialect.  Files cannot be transferred if
  73.         the two programs disagree on parity handling, Such failures are quite
  74.         commonplace.  A common symptom is a transfer that starts up normally
  75.         but always fails at the same block.  Setting appropriate parity
  76.         corrects these Kermit failures.
  77.  
  78.         ZCOMM's Kermit AutoDownload(TM) (enabled with the K mode) allows the
  79.         term function to sense the beginning of a Kermit file download, make
  80.         the proper determination on whether to use 8 bit serial data, and
  81.         execute the file download without user intervention.
  82.  
  83.         13.3.3  Kermit Performance Enhancements  Super-Kermit (Kermit with
  84.         Sliding Windows) transmits multiple packets before waiting for a
  85.         response, increasing throughput with timesharing systems and networks.
  86.         ZCOMM uses sliding windows and CRC error detection if the other
  87.         machine's Kermit supports them.
  88.  
  89.         ZCOMM also supports long packets for increased throughput with
  90.         suitable systems, including many that do not support sliding windows.
  91.         ZCOMM allows Kermit long packets up to 1000 characters on DOS, up to
  92.         2048 on 32 bit Unix systems.
  93.  
  94.         The maximum send packet length is set by the kermit l numeric
  95.         parameter.  ZCOMM will ask for sliding windows if this is set to 94 or
  96.         less.
  97.  
  98.         EXAMPLE: k pl94
  99.  
  100.  
  101.         The maximum receive packet length is set by the kermit L numeric
  102.         parameter.  ZCOMM will ask for sliding windows if this is set to 94 or
  103.         less.
  104.  
  105.         EXAMPLE: k pL94
  106.  
  107.  
  108.         With the default values for the kermit l and kermit L parameters,
  109.         ZCOMM will choose long packets over sliding windows when a choice is
  110.         possible.
  111.  
  112.         ZCOMM supports 12 bit Kermit checksums and 16 bit Kermit CRC for
  113.         professional error detection performance.  ZCOMM uses the most
  114.         reliable Kermit error correction available.  Shorter checksums may be
  115.  
  116.  
  117.         (C) 1990 Omen Tech Inc              Chapter 13 Protocol File Transfers
  118.  
  119.  
  120.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  121.         ZCOMM User Manual                                                   63
  122.  
  123.         forced by changing the kermit b numeric parameter.
  124.  
  125.         13.3.4  Accessing Kermit Servers  The commands to start up a Kermit
  126.         server vary from system to system.  Unix C-Kermit can be started in
  127.         server mode with kermit -ix given to Unix or VMS.  When the Kermit
  128.         server is active, the ZCOMM get, send, and remote ...  commands may be
  129.         used.  The ZCOMM finish command causes the remote Kermit server to
  130.         exit to its operating system.
  131.  
  132.         13.3.5  Kermit Caveats  Some versions of Kermit translate files as
  133.         they are sent, by default!  Typical modifications include CR/LF to NL
  134.         transformations and CPMEOF stripping.  Before transferring binary
  135.         files, such editing must be disabled with SET FILE TYPE BINARY or
  136.         similar commands given to the other program.  The demonstration in
  137.         Chapter 10 includes several Kermit server access and file transfer
  138.         commands.
  139.  
  140.         If the Kermit protocol doesn't work with IBM mainframe communications,
  141.         incorrect ASCII/EBCDIC translate tables may be the problem.
  142.  
  143.         Some mainframe "front ends" require special characters or a break
  144.         signal to recover from transmission errors ("line hits").  The
  145.         kermreset string parameter (q.v.) may be programmed with the required
  146.         sequence.
  147.  
  148.         SEE ALSO: kermreset string parameter
  149.  
  150.         When downloading files from some versions of Kermit, best results may
  151.         sometimes be obtained by starting ZCOMM's kermit receive before typing
  152.         the carriage return that starts the sender on the remote.  If the
  153.         other program includes an adjustable initial delay, you can save time
  154.         by setting it to zero.
  155.  
  156.         SEE ALSO: kermit d numeric parameter
  157.  
  158.         SEE ALSO: K mode (Kermit AutoDownload(TM))
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.         (C) 1990 Omen Tech Inc              Chapter 13 Protocol File Transfers
  177.  
  178.  
  179.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  180.         ZCOMM User Manual                                                   64
  181.  
  182.  
  183.  
  184.         13.4  Uploading Files to Unix Systems
  185.  
  186.         Files may be uploaded to Unix systems conveniently and quickly with
  187.         ZMODEM.  Unix flavors of Professional-YAM support the full ZMODEM-
  188.         90(TM) feature set including Intelligent Crash Recovery(TM) and
  189.         selective transfers with the rz command, a hard link to the
  190.         /usr/bin/yam program.
  191.  
  192.         The undos program may be used to remove carriage returns files
  193.         uploaded to Unix machines.
  194.  
  195.         When accessed over a network, some systems require additional control
  196.         characters to be escaped.  The sz command e option may be used to
  197.         escape all control characters.
  198.  
  199.         SEE ALSO: e option
  200.  
  201.         Individual control characters can be escaped with the zmtxesc string
  202.         parameter.
  203.  
  204.         SEE ALSO: zmtxesc string parameter
  205.  
  206.         If the Unix system is operating with 7 bits, the sender's zmodem d
  207.         parameter may have to be increased to allow the rz program time to
  208.         change Unix to 8 bits for the transfer.
  209.  
  210.         SEE ALSO: zmodem d numeric parameter
  211.  
  212.         Pro-YAM may not be available on a particular system.  The rz program
  213.         supports a subset of ZCOMM's ZMODEM features.[6]
  214.  
  215.         On Unix systems with Professional-YAM installed, the rzsz source files
  216.         and man pages are installed in the /usr/src/command/rzsz directory.
  217.  
  218.         If rz is not installed on the Unix system, unpack the rzsz.zoo file on
  219.         your MSDOS system with: looz x rzsz.zoo given from the DOS prompt.
  220.         Next, the command source zupl.t calls the zupl.t script to upload the
  221.         bootstrap file minirb.c, compile it, and use it to upload the
  222.         remainder of the source files.
  223.  
  224.         After the rest of the files have been uploaded, compile rz.c and sz.c
  225.         using the directions given in the README file and in the C source
  226.         files.
  227.  
  228.         The manual "pages" rz.1 and sz.1 may be formatted with nroff commands
  229.         such as
  230.  
  231.              nroff -Tlp -man rz.1 sz.1
  232.  
  233.  
  234.  
  235.         (C) 1990 Omen Tech Inc              Chapter 13 Protocol File Transfers
  236.  
  237.  
  238.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  239.         ZCOMM User Manual                                                   65
  240.  
  241.         If the target system does not have a compiler, it may be possible to
  242.         compile minirb.c locally, strip the executable file for minumum size,
  243.         uuencode the executable, and transfer the result to the target system.
  244.         Once minirb is operational on the target system, a uuencoded copy of
  245.         rz can be uploaded.[7] This requires the target system to have the
  246.         uudecode program, and a compiler that supports the target system.
  247.  
  248.         13.5  Downloading Files from Unix Systems
  249.  
  250.         To download files from Unix(TM) systems, use the Unix sz command to
  251.         send the desired files to ZCOMM.  To Unix keyboard: sz file ...
  252.         ZCOMM's ZMODEM AutoDownload(TM) takes care of the rest for you, saving
  253.         unnecessary keystrokes.
  254.  
  255.         If one or more of the files already exists on the destination disk,
  256.         use sz -y file ...  instead, to replace the old copies on your
  257.         computer.
  258.  
  259.         Another useful option sends only the files that exist on both
  260.         computers (Y), and furthermore sends only those that are newer (n):
  261.         sz -Yn file ...
  262.  
  263.         When files are long and transmission slow, you can save time by
  264.         squeezing them first with sq.  Source for a Unix compatible version of
  265.         sq is available in xsq.cq.[8] The zoo program, available for DOS and
  266.         Unix, may also be used to compress file(s) before transmission.
  267.  
  268.         Omen Technology products support ZMODEM compression with the Z option.
  269.         All Omen Technology products support compression by Run Length
  270.         Encoding (RLE).  Unix flavors of Professional-YAM also support LZW
  271.         compression.
  272.  
  273.         Unix source files normally do not contain carriage returns used by
  274.         CP/M and DOS.  Some CP/M or DOS programs, such as C compilers, do not
  275.         require carriage returns in the source files.  Others, such as the
  276.         Microsoft Macro Assembler, become quite confused by such files,
  277.         although such files fully meet the requirements of the ASCII standard.
  278.  
  279.         Carriage Returns may be added before downloading with the todos or
  280.         tocpm programs.  Carriage returns may be added during the transfer
  281.         with the sz a option.  Carriage Returns may be added after the
  282.         transfer by some program editors, including uEMACS.  (Other editors,
  283.         such as DOS edlin may crash trying to edit such files.) Short files
  284.  
  285.  
  286.         __________
  287.  
  288.          7. As written, minirb cannot transfer binary files.
  289.  
  290.          8. /usr/src/cmd/xsq.c on Unix systems.
  291.  
  292.  
  293.  
  294.         (C) 1990 Omen Tech Inc              Chapter 13 Protocol File Transfers
  295.  
  296.  
  297.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  298.         ZCOMM User Manual                                                   66
  299.  
  300.         (less than 64kb) may be converted using ZCOMM's read and create
  301.         commands to pass the data through ZCOMM's capture buffer.
  302.  
  303.         Text files may also be downloaded using the capture buffer if sz has
  304.         not been installed on the Unix machine.
  305.  
  306.         If a file or set of files are to be transported between two Unix
  307.         systems, it may be helpful to place them in a tar or cpio archive (and
  308.         possibly squeeze the archive) before transmission.  This procedure
  309.         will preserve the Unix file modes and modification times, and bypass
  310.         pathname restrictions imposed by DOS.
  311.  
  312.         As with rz, Unix Professional-YAM is linked to sz to support the full
  313.         ZMODEM-90(TM) feature set.  Otherwise the separate Unix sz program may
  314.         be obtained as described in the previous subchapter.
  315.  
  316.         13.6  VAX/VMS File Transfers
  317.  
  318.         Most of the comments made above about Unix file transfers apply to VMS
  319.         as well.
  320.  
  321.         Automatic uploads to VMS may require setting the zmodem d (delay)
  322.         numeric parameter to gice time for the VMS rz program to properly
  323.         initialize.
  324.  
  325.         SEE ALSO: zmodem d numeric parameter
  326.  
  327.         EXAMPLE: zmodem pd15
  328.  
  329.  
  330.  
  331.         13.6.1  Version 4 rz/sz  Omen provides VMS flavors of version 4 rz and
  332.         sz precompiled in rzsz.tlb, a VMS "text library".  Version 4 rz
  333.         supports most ZMODEM-90 features including Crash Recovery,
  334.         compression, and MobyTurbo.  Binary uploads write files with a default
  335.         VMS 512 byte fixed length record format.
  336.  
  337.         EXAMPLE: sz biglib.tlb
  338.  
  339.         Sending to VMS with the i option selects the VMS Stream_LF record
  340.         format.  Stream_LF preserves the exact file length and data contents
  341.         when read by C programs.
  342.  
  343.         EXAMPLE: sz -i vmsemacs.exe
  344.  
  345.  
  346.         Sending to VMS with the I option causes the VMS receiver to use
  347.         variable length binary records.  VMS Kermit-32 and some other programs
  348.         understand this record format.
  349.  
  350.         Text files uploaded with the a option are written in variable length
  351.  
  352.  
  353.         (C) 1990 Omen Tech Inc              Chapter 13 Protocol File Transfers
  354.  
  355.  
  356.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  357.         ZCOMM User Manual                                                   67
  358.  
  359.         records with CR carriage control.
  360.  
  361.         EXAMPLE: sz -a emacs*.c
  362.  
  363.  
  364.         Version 4 VMS sz supports standard VMS wild card and directory
  365.         recursion syntax.
  366.  
  367.         EXAMPLE: $ sz -qa [*...]*.prn sends all accessible .prn files on the
  368.         system in ASCII mode. The VMS sz q option suppresses the initial tally
  369.         of the number of files and their lengths.  This tally can take some
  370.         time when a large number of files and directories are invloved.  The f
  371.         option may be added to send directory names as well.
  372.  
  373.  
  374.         If you use Kermit to upload the rzsz.tlb file to VMS, command the
  375.         receiving Kermit program to SET FILE FIXED.  Otherwise Kermit will
  376.         garble the data.
  377.  
  378.  
  379.         13.7  GEnie File Transfers
  380.  
  381.         The General Electric Consumer Information Service service (GEnie) uses
  382.         ZMODEM-90(TM) for efficient downloads.  GEnie's ZMODEM server selects
  383.         ZMODEM RLE Compression or MobyTurbo(TM) for optimum download speed on
  384.         each file.
  385.  
  386.         GEnie uses a large network to provide callers with local access
  387.         numbers.  This requires technical tradeoffs to control data flow in
  388.         the network.  If you are using an MNP modem, download speeds can be
  389.         improved by increasing GEnie's ZMODEM window size.
  390.  
  391.         EXAMPLE: genie24   speed 4800 249-8365/mnp set adlopts "W16384"
  392.  
  393.  
  394.         Startup on Genie ZMODEM AutoDownloads can be speeded up by disabling
  395.         Security Verification.
  396.  
  397.         EXAMPLE:      ena -yZ   :: Disable ZMODEM Security verification
  398.  
  399.  
  400.  
  401.         The sx file.exe command is used for XMODEM-CRC uploads to GEnie.  When
  402.         uploading with XMODEM-CRC, Wait for GEnie's "READY FOR INPUT, start
  403.         your XMODEM upload." message, and then wait for the XMODEM-CRC C to
  404.         appear before issuing the sx command.  Issuing the sx command before
  405.         the C appears may corrupt the uploaded file.
  406.  
  407.         A number of GEnie access scripts are provided in scripts.zoo with
  408.         filenames starting with ge.  The main GEnie login script is provided
  409.         in phones2.t witin scripts.zoo.
  410.  
  411.  
  412.         (C) 1990 Omen Tech Inc              Chapter 13 Protocol File Transfers
  413.  
  414.  
  415.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  416.         ZCOMM User Manual                                                   68
  417.  
  418.         13.8  CompuServe File Transfers
  419.  
  420.         ZCOMM supports CompuServe Quick-B and the faster Extended Quick-B (B+)
  421.         file transfer protocols.  As this is being written, these protocols
  422.         are being revised.  Please check the newest.me file for possible
  423.         changes.
  424.  
  425.         B+ Protocol is used by the CompuServe Timesharing Service through the
  426.         CompuServe, Tymnet, and Telenet networks.  B+ Protocol file transfers
  427.         are initiated by the CompuServe computer.  The B+ Protocol file
  428.         transfer protocol is well supported by this timesharing service.
  429.         Under typical conditions, the B+ Protocol saves 35 per cent or more in
  430.         file transmission time and connect charges compared to XMODEM protocol
  431.         transfers.
  432.  
  433.         The c or C mode must be set with ena -c or ena -C to allow the B+
  434.         protocol to seize control and transfer files.
  435.  
  436.         The adlopts string parameter allows the y and v file transfer options
  437.         to be specified for CIS-B transfers.
  438.  
  439.         The w numeric parameter controls the block length used by the
  440.         CompuServe B+ Protocol.  A longer length increases throughput, but may
  441.         overload some networks, resulting in excessive retransmissions or
  442.         failed transfers.  With the new Extended Quick-B protocol, the maximum
  443.         block length is 1024 data bytes.  A value of 0 (the default) allows
  444.         the Compuserve computer to control the block length, up to 1024 with
  445.         Extended Quick-B.
  446.  
  447.         A negative value controls the upload block length but still allows
  448.         Compuserve to control the download block length (1024 with Extended
  449.         Quick B).
  450.  
  451.         Uploads to Compuserve using longer block lengths are especially
  452.         sensitive to poor flow control, especially when error correcting
  453.         modems (MNP, etc.) are used.  If B protocol uploads fail or require
  454.         excessive retransmissions, correct the flow control arrangements,
  455.         disable the modem's error correction, or try a smaller upload block
  456.         size.
  457.  
  458.         The data contents of successfully transferred file(s) are not affected
  459.         by this parameter.
  460.  
  461.         Some networks may garble data when Quick-B's streaming causes ZCOMM to
  462.         respond to incoming data concurrently with incoming data.  The o
  463.         numeric parameter can be set to 0 to disable streaming (send-ahead).
  464.  
  465.         It is essential to use the same interface speed to the modem as the
  466.         modem's transmission rate when uploading files with B+ protocol.  If
  467.         the modem buffers any characters, ZCOMM's response to CompuServe's
  468.         flow control will be too slow to prevent loss of data.
  469.  
  470.  
  471.         (C) 1990 Omen Tech Inc              Chapter 13 Protocol File Transfers
  472.  
  473.  
  474.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  475.         ZCOMM User Manual                                                   69
  476.  
  477.         The CompuServe B+ Protocol controls all file transfer operations
  478.         (except permission to overwrite files) from the timesharing system.
  479.  
  480.         Waiting for long files to download can be boring.  You can start the
  481.         transfer and walk away from the computer, but CompuServe will stay
  482.         connected for 15 minute$ after the transfer is finished if you don't
  483.         come back when the download finishes.  This expense can be avoided by
  484.         typing ALT-Q once the protocol transfer has started.  ALT-Q tells
  485.         ZCOMM to disconnect as soon as the protocol transfer is completed,
  486.         stopping the connect charges.  An alternative method is to control the
  487.         transfers with a script, using either ejryam or the less sophisticated
  488.         cissig and dow.t scripts included with the software distribution.
  489.  
  490.         When "browsing" through CompuServe's software "downloading section"
  491.         libraries, the kcisdl.t script file and ZCOMM allow you to download a
  492.         file with a single keystroke: F3.  Installation instructions are
  493.         provided in that file.
  494.  
  495.  
  496.         13.9  BIX File Transfers
  497.  
  498.         BIX (Byte Information Exchange) supports ZMODEM-90 and Kermit file
  499.         transfers.
  500.  
  501.         The Tymnet phone number in the bix telephone directory entry should be
  502.         changed for your calling area.  Other scripts are provided to handle
  503.         BIX mail and conferences.
  504.  
  505.         When setting up a new BIX account, give the command call bix,new to
  506.         force a login to the BIX new account program.
  507.  
  508.         Be sure to select ZMODEM downloads and Kermit (sliding windows)
  509.         uploads with the BIX "OPTIONS" menu choice.  Set the Zcomm adlopts
  510.         string variable to m or mr to enable MobyTurbo and ZMODEM Crash
  511.         Recovery.
  512.  
  513.         BIX's transfer time predictions are about 40 per cent too pessimistic
  514.         for ZMODEM transfers.
  515.  
  516.         A number of BIX scripts are included in SCRIPTS.ZOO.
  517.  
  518.         13.10  User Exit Processing
  519.  
  520.         The onclosetx and oncloserx string parameters provide a facility to
  521.         perform user defined file related functions ("user exits") immediately
  522.         after each file is closed, while the protocol is still active.  Wild
  523.         card filename expansionss are not allowed in this context.
  524.  
  525.         The oncloserx string parameter may be used to perform user commands or
  526.         call a script once for each file received with a file transfer
  527.         protocol.
  528.  
  529.  
  530.         (C) 1990 Omen Tech Inc              Chapter 13 Protocol File Transfers
  531.  
  532.  
  533.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  534.         ZCOMM User Manual                                                   70
  535.  
  536.         EXAMPLE: set oncloserx @crc %rname; obey "!%mv %rname /tmp"
  537.         When each file is received, the crc command calculates and displays a
  538.         CRC for the file.
  539.  
  540.         Then the !% command calls the mv program to move the file just
  541.         received to the /tmp directory.  The "%" in the "!%" command causes
  542.         the rest of the command string to be processed for string
  543.         substitutions.
  544.  
  545.  
  546.         The onclosetx string parameter may be used to perform user commands or
  547.         call a script once for each file sent with a file transfer protocol.
  548.         Wild card file name expansions may not be used in onclosetx.
  549.  
  550.         EXAMPLE: The following causes each successfully sent file to be moved
  551.         to the /done directory.
  552.              set onclosetx
  553.         @if !d? obey "!%mv %rname /done"
  554.  
  555.  
  556.         SEE ALSO: rname, tname, drive, pwd string parameters, ?, d?  test
  557.         conditions
  558.  
  559.         User exits will cause protocol timeouts if their execution takes too
  560.         long.  Since both Zcomm and the remote machine are still executing
  561.         file transfer protocols when user exits are called, user exits can not
  562.         use the serial port.
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.         (C) 1990 Omen Tech Inc                    Chapter 13 Message Transfers
  590.  
  591.  
  592.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  593.         ZCOMM User Manual                                                   71
  594.  
  595.         14.  MESSAGE TRANSFERS
  596.  
  597.         14.1  Downloading Messages
  598.  
  599.         ZCOMM is flexible capturing output from other systems.  The trick is
  600.         to make the remote send the information without too much
  601.         embellishment.
  602.  
  603.         When downloading files without a file transfer protocol, set the
  604.         timesharing system to send tabs as tab characters without expanding
  605.         them to spaces.  Turn off fill characters.  These extra characters
  606.         waste time and money and ZCOMM doesn't need them.  ZCOMM's s and S
  607.         modes can be used to strip control characters and escape sequences
  608.         from the capture download.
  609.  
  610.         EXAMPLE: t -s file
  611.  
  612.  
  613.         If the remote system responds to XOFF and XON, E mode may be enabled
  614.         to allow Error Containment(TM) to reduce the number of characters
  615.         garbled by "line hits".
  616.  
  617.         EXAMPLE: t -E7e file1 uses Error Containment to download file1 from a
  618.         system using 7 bits even parity.  Error Containment works best when
  619.         even or odd parity is available.
  620.  
  621.  
  622.         SEE ALSO: E, j, S, s modes
  623.  
  624.         14.1.1  XON/XOFF  Files of arbitrary length may be transferred if the
  625.         remote supports flow control with the ASCII XOFF and XON control
  626.         characters.  Output from most timesharing services may be captured to
  627.         a file using this method.
  628.  
  629.         To download a file with XON/XOFF flow control: t file1
  630.  
  631.  
  632.         14.1.2  DC2/DC4 (^R/^T)  Some bulletin boards support file downloads
  633.         by issuing a DC2 to open a capture buffer, sending the file, and
  634.         terminating the capture with DC4.  ZCOMM does not support this
  635.         "protocol" directly.  The review t and b commands can be used to strip
  636.         excess characters from the circular buffer before writing the file to
  637.         disk.
  638.  
  639.         This "protocol" can be implemented with Turbodial(TM) script commands:
  640.  
  641.         EXAMPLE: pat 1c "\022" "@kill; create capture.fil"
  642.              pat 2c "\024" "close"
  643.  
  644.  
  645.  
  646.  
  647.  
  648.         (C) 1990 Omen Tech Inc                    Chapter 14 Message Transfers
  649.  
  650.  
  651.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  652.         ZCOMM User Manual                                                   72
  653.  
  654.         14.1.3  Data Dump  Sometimes no flow control is available.  The fget *
  655.         command allows ZCOMM to accept a continuous stream of data at a
  656.         maximum data rate determined by the hardware and software environment.
  657.         With a hard disk, excellent results have been obtained with a 4.77 mHz
  658.         PC accepting graphics dumps at 9600 bps.
  659.  
  660.         EXAMPLE: fget file1
  661.  
  662.  
  663.         At slower speeds or with a fast computer, the term function j mode*
  664.         may be used for nonstop file capture.
  665.  
  666.         EXAMPLE: t -j file1
  667.  
  668.  
  669.         The fget command does not provide a progress display.  While this
  670.         allows the fastest possible data capture (38400 bps on a suitable
  671.         computer), sometimes there is no handy way to monitor the flow of
  672.         data.
  673.  
  674.         The term function I (super-image) mode may be used to capture a binary
  675.         file, provided CRT emulation is disabled with a display dumb command
  676.         or by enabling v mode.
  677.  
  678.         EXAMPLE: display dumb; t -Ij file1
  679.  
  680.         The fax directory entry in PHONES2.T gives another example of how
  681.         ZCOMM's data capture modes may be used to capture binary data.
  682.  
  683.         14.2  Uploading Messages
  684.  
  685.         It is often possible to upload files using the f command with one or
  686.         more modes (such as w or p, possibly in combination with t).
  687.  
  688.         Message uploads are more reliable if you keyboard enab flow before
  689.         connecting through Telenet.  If using Tymnet, type ^R^X just before
  690.         the host computer name to enable flow control with XOFF and XON.
  691.         Check with your network's documentation for further details or updates
  692.         to this information.
  693.  
  694.         It often helps to use "half duplex" ( h mode) with the computer echo
  695.         disabled when uploading files to the computer.  This saves the
  696.         computer from wasting precious time echoing characters.
  697.  
  698.         Another tactic is to avoid uncorrected message transfers during peak
  699.         hours.  Telephone usage peaks during midday with a resulting increase
  700.         in noise induced line hits.  Timesharing computers and communications
  701.         networks are more likely to drop characters due to buffer overloading
  702.         during high traffic periods as well.
  703.  
  704.  
  705.  
  706.  
  707.         (C) 1990 Omen Tech Inc                    Chapter 14 Message Transfers
  708.  
  709.  
  710.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  711.         ZCOMM User Manual                                                   73
  712.  
  713.         14.2.1  Paced  Some systems accept characters only at a certain rate,
  714.         a slow speed for each character and possibly a pause at the end of
  715.         each line.  Depending on the particular system, data transfer may have
  716.         to pause briefly at the end of the line,[1] or wait for a particular
  717.         character to signify readiness to accept the next line.  There may be
  718.         an additional delay after that[2] before the remote is able to accept
  719.         more data.
  720.  
  721.         EXAMPLE: f -p file1 uploads file1 with a wait for the linefeed echo at
  722.         the end of each transmitted line.
  723.  
  724.  
  725.         EXAMPLE: pg63; f -p file1 Sets the prompt character to decimal 63
  726.         ("?") and sends the file with a wait for "?" after each transmitted
  727.         line.
  728.  
  729.         As with the fpute command, the remote system must be commanded to open
  730.         and close the file.
  731.  
  732.         14.2.2  Throttle  Another method of slowing message uploads is the
  733.         throttle, activated by t mode.  Throttle artificially slows Zcomm's
  734.         character transmission to allow more time for the receiving system to
  735.         digest each character. The speed of transmission with t mode is
  736.         controlled by the t numeric parameter.
  737.  
  738.         EXAMPLE: f -t secret.msg
  739.  
  740.         Really slow systems may require both throttle and pacing to send data
  741.         efficiently without loss.
  742.  
  743.         EXAMPLE: f -tp turkey.slo
  744.  
  745.  
  746.         14.2.3  Uploading to IBM Mainframes  Text files can be uploaded to IBM
  747.         mainframes using the P (upper case) mode.  When the P mode is
  748.         activated, ZCOMM will wait for an XON (^Q) after sending each line.
  749.         In this special mode, ZCOMM will not time out waiting for the XON, no
  750.         matter how long it takes for the IBM front end to send it.  If, for
  751.         some reason, the front end fails to send the XON, (or if it is garbled
  752.         in transmission), Ctrl-Q may be keyboarded.
  753.  
  754.         EXAMPLE: f -P file1
  755.  
  756.  
  757.  
  758.         __________
  759.  
  760.          1. Controlled by the p numeric parameter
  761.  
  762.          2. Controlled by the q numeric parameter
  763.  
  764.  
  765.  
  766.         (C) 1990 Omen Tech Inc                    Chapter 14 Message Transfers
  767.  
  768.  
  769.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  770.         ZCOMM User Manual                                                   74
  771.  
  772.         SEE ALSO: P mode, Kermit protocol
  773.  
  774.         14.2.4  Uploading Messages to Bulletin Boards  The greatest file
  775.         transfer challenge is to upload a file to a bulletin board message
  776.         system running on a tiny microcomputer.  Bulletin board message
  777.         systems have a rich variety of operating sequences and timing
  778.         dependencies matched only by the proliferation of incompatible
  779.         dialects of Basic and Pascal.
  780.  
  781.         Message upload from files to bulletin boards reduces connect time and
  782.         $welling of the Phone Bill.  Unattended message transfer saves the
  783.         user's time, especially if the board is difficult to access.
  784.  
  785.         The t, p and w modes and the g, p, t, and q numeric parameters allow
  786.         disk files to be uploaded to such systems.
  787.  
  788.         The basic program cbbsck.bas may be used (perhaps with modifications)
  789.         to check that a message file does not violate the restrictions of the
  790.         message system being uploaded to.  A C version is also available.
  791.  
  792.         EXAMPLE: f -pt file1
  793.  
  794.  
  795.         14.2.5  Uploading to CompuServe SIGS  A file may be uploaded to a
  796.         CompuServe SIG (Special Interest Group) editor with p mode and the g
  797.         numeric parameter set to colon.  When the file has been transferred,
  798.         hit ENTER to send a blank line to terminate message entry.
  799.  
  800.         EXAMPLE: set eolstr "\r."; pp1000; pg58; f -p FILE Is useful for
  801.         uploading a prepared message to Compuserve's bulletin boards.  This
  802.         setting for eolstr inserts a carriage return and period after each
  803.         line to prevent the CompuServe software from reformatting the message.
  804.  
  805.  
  806.         EXAMPLE: pp1000, pg58, and f -p FILE transmits FILE waiting for the
  807.         prompt character ":" before sending each line after the first.
  808.  
  809.  
  810.         An alternative is to set the SIG "FIL" option, which calls the EDIT
  811.         editor.  The cisupl script file referenced by phones2.t uses the SIG
  812.         "FIL" editor option.
  813.  
  814.         Compuserve nodes often drop characters when files are uploaded at full
  815.         speed in full duplex.  This can be avoided by using h mode (local
  816.         echo) and turning off Compuserve's echo.
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.         (C) 1990 Omen Tech Inc                    Chapter 14 Message Transfers
  826.  
  827.  
  828.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  829.         ZCOMM User Manual                                                   75
  830.  
  831.         14.3  Fpute: Echoplex Uploads
  832.  
  833.         Text files can often be uploaded reasonably efficiently using the
  834.         fpute command.* Fpute waits for an echo to each character sent to the
  835.         remote.  Fpute provides modest throughput without loss of data for
  836.         systems with terminal ports designed for keyboard data entry.  The
  837.         maximum speed with fpute is limited to about 1/3 the normal character
  838.         rate by echo delays.  There is no error correction with fpute, but
  839.         character by character handshaking prevents lost data caused by buffer
  840.         overflow.  If possible, TABS should be set to echo as TAB characters
  841.         and not as spaces.  Before the fpute command is given, the remote
  842.         system must be instructed to enter data from the "terminal" to a file.
  843.         After the file has been sent, the remote system must be instructed to
  844.         close the file.
  845.  
  846.         EXAMPLE: fpute file1
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.         (C) 1990 Omen Tech Inc                         Chapter 14 Flow Control
  885.  
  886.  
  887.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  888.         ZCOMM User Manual                                                   76
  889.  
  890.         15.  FLOW CONTROL
  891.  
  892.         All of us must sometimes tell people to "slow down" lest they overload
  893.         us with information faster than we can write it down.  "Wait!" is a
  894.         Flow Control Signal for the English language.  When the receiving
  895.         ZCOMM complains about Garbled Data Subpacket or Line Status Register
  896.         01 you should suspect a flow control problem.
  897.  
  898.         When buffered modems, timesharing systems, networks, or computers of
  899.         differing speeds are involved, a machine readable "Wait!" signal is
  900.         required.
  901.  
  902.         Flow control is sometimes necessary to display long messages without
  903.         skipping over the good parts.  If you see pieces of text missing from
  904.         messages but don't see the usual funny characters caused by line
  905.         noise, ypu have a flow control problem.
  906.  
  907.         File transfers that use long blocks or streaming protocols may not
  908.         work well unless slower parts of the system regulate the speed of
  909.         transmission to prevent loss of data.  With ZMODEM, SuperKermit, and
  910.         other streaming protocols, inexplicable retransmissions of data
  911.         blocks, often at regular intervals, indicate flow control failure.
  912.  
  913.         If you wish to keep things simple, the sending computer should not
  914.         operate at a higher interface speed than the slowest link in the
  915.         network.  Otherwise precautions must be taken to prevent data loss
  916.         with interactive operations and unnecessary retransmissions with
  917.         streaming file transfer protcols.
  918.  
  919.         ZCOMM, ZCOMM, and DSZ default to software flow control with XON and
  920.         XOFF characters.[1] When used with modems that require hardware flow
  921.         control, the handshake command (q.v.) should be used to specify which
  922.         hardware lines are to be used for flow control.
  923.  
  924.         Non transparent software flow control is incompatible with Emacs
  925.         editors, XMODEM and YMODEM transfers.  XMODEM and YMODEM require
  926.         complete transparency to all 256 8 bit codes.  An XMODEM transfer that
  927.         always fails at the same block results from non transparent flow
  928.         control.  When XMODEM-1k and YMODEM-1k are used, the network must
  929.         assert flow control, or handle bursts of 1040 characters without data
  930.         loss.  When X.25 or hardware CTS is unavailable, flow control that
  931.         does not "eat" any characters may be used with XMODEM and YMODEM.
  932.         When buffers fill up, an XOFF should be emitted.  An XON should be
  933.  
  934.  
  935.         __________
  936.  
  937.          1. The PCDOS flavor enables "handshake both" when selecting a port
  938.             with an active Clear To Send (CTS) signal that was previously
  939.             initialized to a speed greater than 2400 bps
  940.  
  941.  
  942.  
  943.         (C) 1990 Omen Tech Inc                         Chapter 15 Flow Control
  944.  
  945.  
  946.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  947.         ZCOMM User Manual                                                   77
  948.  
  949.         sent when the buffer has emptied.  Otherwise, the network should
  950.         neither generate nor eat XON or XOFF characters.
  951.  
  952.         On Telenet, this is obtained by setting CCIT X3 5:1 and 12:1 in the
  953.         PADs (Packet Assembler Dissassembler) at both ends of the network.
  954.         Packets should be forwarded when the packet is a full 128 bytes, or
  955.         after a moderate delay (3:0,4:10).  Set parameter 5 to 1 at both ends
  956.         AFTER one is connected to the remote modem.  (Sorry, these commands
  957.         must be given each time you connect to a modem in the far city!)
  958.              <ENTER>@<ENTER>
  959.              set 5:1<ENTER>
  960.              rst? 5:1<ENTER>
  961.              cont<ENTER>
  962.         ZMODEM and Kermit protect all 4 XOFF and XON characters, commonly used
  963.         network control characters and trigger strings.  ZMODEM and Kermit are
  964.         compatible with many networks that do not support XMODEM family
  965.         protocols, including some that claim network compatibility.  For PADs
  966.         that do not accept "rst?", use:
  967.              <ENTER>@<ENTER>
  968.              set 4:2,5:1,12:1<ENTER>
  969.              cont<ENTER>
  970.         For best Telenet download throughput, parameter 64 (advance ACK)
  971.         should be set to 7.  The parameter 0 is a dummy argument that
  972.         distinguishes Telenet parameters from CCIT parameters.
  973.              <ENTER>@<ENTER>
  974.              set 0:0,64:7<ENTER>
  975.              cont<ENTER>
  976.         Sometimes Telenet flow control stops data transmission when the
  977.         network buffers are not yet full.  If you often see "STOPPED" flashing
  978.         in the status line (DOS versions), or if you see the modem send data
  979.         light pause in a ZMODEM or SuperKermit file send, poor flow control
  980.         may be the culprit.  Such slowdowns are typical when a network is
  981.         overloaded.  If this condition persists, the network should take steps
  982.         to reduce the congestion.  Turning OFF network flow control and
  983.         activating ZMODEM's or SuperKermit's protocol flow control may
  984.         increase throughput under these conditions.
  985.  
  986.         Instead of or in addition to XON/XOFF flow control, the sending
  987.         program's ZMODEM w numeric parameter can restrict the window size to a
  988.         value that does not overload the network.  A zmodem pw2048 command
  989.         restricts the window size (maximum number of bytes in transit) to
  990.         2048.  This causes the sz command to trigger the receiver's
  991.         acknowledgement every 512 bytes (one fourth the value of the ZMODEM w
  992.         numeric parameter).  The sender monitors these responses and suspends
  993.         transmission when necessary to restrict the window to the specified
  994.         size.  Until a network dependent lower limit is reached, lower window
  995.         sizes improve the speed of error recovery at the expense of slight
  996.         increases in protocol overhead.  When the window size becomes less
  997.         than the number of characters sent within the network's transit time,
  998.         throughput falls off rapidly.  Frequent protocol acknowledgements slow
  999.         down high speed psuedo full duplex modems (US Robotics HST, Telebit
  1000.  
  1001.  
  1002.         (C) 1990 Omen Tech Inc                         Chapter 15 Flow Control
  1003.  
  1004.  
  1005.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1006.         ZCOMM User Manual                                                   78
  1007.  
  1008.         TrailBlazer) and should be avoided.
  1009.  
  1010.         ZMODEM-90(TM) allows the receiver to specify the window size with the
  1011.         -Wn option where n is the desired window size.
  1012.  
  1013.         EXAMPLE: set adlopts W8192 requests an 8193 byte window size.
  1014.  
  1015.  
  1016.         Some modems and networks can be configured to flush (discard the
  1017.         contents of) their buffers when a break signal is received.  If this
  1018.         is possible, error recovery with ZMODEM transfers may be speeded up by
  1019.         setting the ZMODEM b parameter to 1, which sends a break whenever the
  1020.         ZMODEM sending program gets a retransmission request.
  1021.                      Network and Flow Control (FC) Compatibility
  1022.  
  1023.         ______________________________________________________________________
  1024.         |    Network     | Interactive | XMODEM | WXMODEM | S-KERMIT | ZMODEM |
  1025.         |________________|_____________|________|_________|__________|________|
  1026.         |No Network      | YES         | YES    | YES     | YES      | YES    |
  1027.         |8 bit, no FC    | NO          | YES    | YES     | YES(1)   | YES(1) |
  1028.         |Transparent FC  | YES         | YES    | YES     | YES      | YES    |
  1029.         |Non Transparent | YES         | NO     | NO      | YES      | YES    |
  1030.         |7 bit           | YES         | NO     | NO      | YES      | YES(2) |
  1031.         |________________|_____________|________|_________|__________|________|
  1032.  
  1033.         (1) Window size must be restricted to avoid buffer overrun if the
  1034.         network cannot transfer data at full speed.
  1035.         (2) Requires ZMODEM-90(TM) 7-bit support
  1036.  
  1037.         15.1  Got ZRPOS Errors
  1038.  
  1039.         Got ZRPOS indicates the receiving program has detected a transmission
  1040.         error and has requested retransmission.  In other words, ZMODEM is
  1041.         doing its job of detecting and correcting missing and garbled data.
  1042.  
  1043.         If this happens with error correcting modems, or more often than
  1044.         observed line noise would suggest, the receiver's error messages must
  1045.         be studied.  "Line Status Register 01" messages indicate a flow
  1046.         control problem.  "Line Status Register 02" messages suggest a
  1047.         receiver problem with interrupt latency.
  1048.  
  1049.         Otherwise, the sender may have a flow control problem in one of four
  1050.         areas:
  1051.  
  1052.           + Between the sending program and its modem.  If using an interface
  1053.             speed higher than the transmission speed, or modem to modem error
  1054.             correction (MNP, LAPB, PEP, etc.), check that the modem and the
  1055.             sending program are configured for the same flow control methods.
  1056.             Omen Technology's software is faster than most other programs, and
  1057.             may expose flow control problems not seen with slower software.
  1058.  
  1059.  
  1060.  
  1061.         (C) 1990 Omen Tech Inc                         Chapter 15 Flow Control
  1062.  
  1063.  
  1064.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1065.         ZCOMM User Manual                                                   79
  1066.  
  1067.           + Between the sending modem and the network.  Correcting this
  1068.             requires "handshake both" to allow the sending program to honor
  1069.             both hardware (CTS) flow control from the modem and software flow
  1070.             control (XON/XOFF) from the network.
  1071.  
  1072.           + Between parts of the network.
  1073.  
  1074.           + Between the receiving modem and the receiving program.  This can
  1075.             happen at high transmission speeds when the receiver has specified
  1076.             a large I/O buffer size with the B numeric parameter.
  1077.  
  1078.             Excessive interrupt latency from extended memory ramdisks or disk
  1079.             caches, and poorly written hard disk drivers also wreak havoc on
  1080.             streaming protocols but do not affect start-stop protocols
  1081.             (XMODEM, etc.).  Problems with extended memory disk caches may
  1082.             cause errors at regular intervals; check the receiver's error
  1083.             messages.
  1084.  
  1085.             To work around these problems, give the "handshake slow" command
  1086.             to the receiver.
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.         (C) 1990 Omen Tech Inc                       Chapter 15 Running ZCOMM
  1121.  
  1122.  
  1123.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1124.         ZCOMM User Manual                                                   80
  1125.  
  1126.         16.  RUNNING ZCOMM
  1127.  
  1128.         Before running ZCOMM, the keyboard Caps Lock should be turned off.
  1129.         ZCOMM commands and most arguments must be entered in lower case.
  1130.  
  1131.  
  1132.         16.1  Running ZCOMM from DOS
  1133.  
  1134.         ZCOMM is called from DOS as ZCOMM [DPORT=n] [command ...]
  1135.  
  1136.         The following special commands may be given from the command line
  1137.         only.
  1138.  
  1139.         DPORT=n is an optional override to the default comm port.  If another
  1140.                 program is using the default comm port, ZCOMM may be told to
  1141.                 use another port to prevent interference.
  1142.  
  1143.                 SEE ALSO: DPORT environment variable
  1144.  
  1145.         Command may be any desired combination of ZCOMM commands.  Command
  1146.         line arguments to ZCOMM must be in lower case except as noted.
  1147.  
  1148.         EXAMPLE: C>ZCOMM call cissig invokes ZCOMM and executes the commands
  1149.         in the "cissig" telephone directory entry.
  1150.  
  1151.  
  1152.         EXAMPLE: C>ZCOMM DPORT=2 call othersys
  1153.         Selects COM2 before initializing the serial port
  1154.  
  1155.  
  1156.  
  1157.         16.1.1  DOS Environment Variables  DOS environment variables are set
  1158.         with the DOS set command in the form SET VARIABLE=VALUE given in a
  1159.         batch file or at the DOS prompt.
  1160.  
  1161.         NOTE: There must not be any spaces before or after the "=" sign.  If
  1162.         you set many environment variables, DOS will quietly forget some of
  1163.         them unless you tell DOS to make more room for them.  You can issue
  1164.         the DOS "set" command by itself to check the accuracy of DOS
  1165.         environment variables.
  1166.  
  1167.         ZCOMM searches the DOS Environment for the following variables:
  1168.  
  1169.         CBSIZE overrides the default allocation for the circular buffer.** If
  1170.               memory is limited, the DOS command SET CBSIZE=3000 will leave
  1171.               more memory for DOS Gateway or other programs.  CBSIZE may be
  1172.               set as high as 65500.
  1173.  
  1174.               EXAMPLE: C>SET CBSIZE=65000
  1175.  
  1176.  
  1177.  
  1178.  
  1179.         (C) 1990 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1180.  
  1181.  
  1182.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1183.         ZCOMM User Manual                                                   81
  1184.  
  1185.         COMSPEC ZCOMM uses the DOS COMSPEC environment variable to load
  1186.               COMMAND.COM or similar program to parse and execute DOS gateways
  1187.               (shell escapes).
  1188.  
  1189.         DIRRX, DIRSX, DIRCX, DIRPX, DIRFX Contain optional receive (DIRRX),
  1190.               send (DIRSX), capture (DIRCX), paste (DIRPX), and file (DIRFX)
  1191.               directory presets.  When ZCOMM starts, these environment
  1192.               variables preset the dirrx, dirsx, dircx, dirpx and dirfx string
  1193.               variables respectively.
  1194.  
  1195.         DIRSIZE controls the number of directory items that may be sorted with
  1196.               each wildcard.  It should be set to 23 * times the desired
  1197.               number of entries (default = 200).  If more directory entries
  1198.               are encountered, they are processed without sorting.
  1199.  
  1200.               EXAMPLE: C>set DIRSIZE=8000
  1201.  
  1202.  
  1203.         DPORT overrides the default modem port (COM1) initially accessed by
  1204.               ZCOMM.
  1205.  
  1206.               EXAMPLE: C>set DPORT=2
  1207.  
  1208.               The DPORT environment variable can also be specified as a hex
  1209.               port address,vector number pair.
  1210.  
  1211.               EXAMPLE: C>set DPORT=2f8,5
  1212.  
  1213.  
  1214.               SEE ALSO: portx command
  1215.  
  1216.         EGA   Stting this to MONO causes ZCOMM to use video mode 7 for 80x25
  1217.               column text instead of the default video mode 3.  This is needed
  1218.               when using some EGA cards with an Monochrome MDA compatible
  1219.               monitor.
  1220.  
  1221.               EXAMPLE: C>set EGA=MONO
  1222.  
  1223.  
  1224.         HOTPORT Suppresses the "Warning: Old dport=" message (q.v.) seen when
  1225.               Zcomm is called from certain operating systems or programs.
  1226.  
  1227.               EXAMPLE: C>set HOTPORT=1
  1228.  
  1229.  
  1230.               SEE ALSO: port, portx commands
  1231.  
  1232.         MODEM Describes the type of modem used by the mm224e.t script.  See
  1233.               Chapter 9 for details.
  1234.  
  1235.               EXAMPLE: C>set MODEM=mm224e.t
  1236.  
  1237.  
  1238.         (C) 1990 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1239.  
  1240.  
  1241.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1242.         ZCOMM User Manual                                                   82
  1243.  
  1244.         PATH  must include the directories containing ZCOMM and the help
  1245.               processor YHP.
  1246.  
  1247.         PHONES overrides the default pathname used to fetch ZCOMM's telephone
  1248.               directory.  Forward slashes should be used to indicate
  1249.               directories.
  1250.  
  1251.               EXAMPLE: C>set PHONES=c:/yam/phones.t
  1252.  
  1253.  
  1254.         YAMQUIET Inhibits the display and locks the keyboard, preventing ZCOMM
  1255.               from writing on the screen. * This is useful when calling ZCOMM
  1256.               from another program.
  1257.  
  1258.               EXAMPLE: C>set YAMQUIET=257 Performs the equivalent of an
  1259.               initial kbdlock 257 command.
  1260.  
  1261.  
  1262.               SEE ALSO: kbdlock command
  1263.  
  1264.         ZONE  sets the z numeric parameter to the number of minutes the
  1265.               current local time lags GMT time.
  1266.  
  1267.               EXAMPLE: C>set ZONE=420
  1268.  
  1269.  
  1270.               SEE ALSO: z numeric parameter
  1271.  
  1272.         Before running the X.PC* version of Pro-YAM, you must run the Tymnet
  1273.         X.PC driver to make it resident by calling the driver from DOS.  The
  1274.         driver announces itself and returns control to DOS.  The Tymnet X.PC
  1275.         driver uses approximately 40kb memory.
  1276.  
  1277.         EXAMPLE: xpcmain
  1278.  
  1279.  
  1280.  
  1281.         16.1.2  Help Program Environment Variables  The flash-up help
  1282.         processor program YHP examines the environment for the NORMATTR,
  1283.         REVATTR, and UNDLATTR variables.  These set help screen parameters for
  1284.         normal, reverse video, and underline attributes corresponding to the
  1285.         n,r, and u numeric parameters.
  1286.  
  1287.         EXAMPLE: C>set NORMATTR=3
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.         (C) 1990 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1298.  
  1299.  
  1300.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1301.         ZCOMM User Manual                                                   83
  1302.  
  1303.         16.2  Dialing out from Unix
  1304.  
  1305.         ZCOMM is called from Unix as [DPORT=S] yam [command ...]
  1306.         DPORT=S is an optional override to the initial default serial line.
  1307.  
  1308.         If another program is using the line, ZCOMM complains that the port is
  1309.         busy and will refuse to open it.
  1310.  
  1311.         Command may be any desired combination of ZCOMM commands.
  1312.  
  1313.         EXAMPLE: yam call cissig invokes ZCOMM and executes the commands in
  1314.         the "cissig" telephone directory entry.
  1315.  
  1316.  
  1317.         EXAMPLE: DPORT=tty77 yam call othersys
  1318.         Selects /dev/tty77 before executing the othersys telephone directory
  1319.         entry.
  1320.  
  1321.  
  1322.         If ZCOMM is run in the background, it will exit if it reaches the main
  1323.         command prompt.
  1324.  
  1325.         EXAMPLE: yam call cissig&
  1326.  
  1327.  
  1328.         As a form of shorthand, ZCOMM may be invoked as call if that is the
  1329.         command to be executed.
  1330.  
  1331.         EXAMPLE: call cissig
  1332.  
  1333.  
  1334.  
  1335.         16.2.1  X Windows  When run under the X Windows xterm(1) interface
  1336.         program (indicated by the Unix TERM environment variable), ZCOMM
  1337.         understands xterm's keyboard mappings for function and ALT keys.
  1338.  
  1339.  
  1340.         16.2.2  UNIX/XENIX Environment Variables  Unix/Xenix ZCOMM flavors
  1341.         search the Environment for the following variables:
  1342.  
  1343.         CBSIZE overrides the default allocation for the circular buffer.  On
  1344.               32 bit systems, the maximum CBSIZE is limited only by the
  1345.               operating system's process size limit.
  1346.  
  1347.               EXAMPLE: CBSIZE=300000; export CBSIZE
  1348.  
  1349.  
  1350.         DIRRX, DIRSX, DIRCX, DIRPX, DIRFX Perform the same function as
  1351.               described for the DOS flavor above.  (Since Unix does not use
  1352.               colon (:) as a device specifier, Unix flavors do not treat
  1353.               colon(s) in pathnames in any special way.)
  1354.  
  1355.  
  1356.         (C) 1990 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1357.  
  1358.  
  1359.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1360.         ZCOMM User Manual                                                   84
  1361.  
  1362.         DPORT overrides the default modem port initially accessed by ZCOMM.
  1363.  
  1364.               EXAMPLE: DPORT=tty12; export DPORT
  1365.  
  1366.  
  1367.         HZ    Indicates the number of kernel "clock ticks" per second.  This
  1368.               calibrates terminal function timeouts, protocol timeouts, and
  1369.               the sleep command.  The HZ environment variable must be set if
  1370.               the value used by your system is not 100 clock ticks per second.
  1371.  
  1372.         LOGFILE Specifies the pathname for the log file (default:
  1373.               /tmp/yamlog.tmp) created by the -v option when invoking ZCOMM as
  1374.               xyam, rz, sz, rb, sb, rx, or sx.
  1375.  
  1376.               SEE ALSO: v option
  1377.  
  1378.         MODEM Describes the type of modem used by the mm224 script.  See
  1379.               Chapter 9 for details.
  1380.  
  1381.               EXAMPLE: MODEM=MM224E; export MODEM
  1382.  
  1383.  
  1384.         PATH  must include the directories containing yam and the help
  1385.               processor yhp.
  1386.  
  1387.         PHONES overrides the default pathname used to fetch ZCOMM's telephone
  1388.               directory.
  1389.  
  1390.               EXAMPLE: PHONES=/usr/lib/local/localphone.t; export PHONES
  1391.  
  1392.  
  1393.         SHELL ZCOMM uses this environment variable to select the appropriate
  1394.               program for its shell escapes.
  1395.  
  1396.         TERM  If the TERM environment variable contains xterm, xterms or
  1397.               anything else beginning with xterm, ZCOMM assumes it is
  1398.               operating as a subprocess to the Xwindows xterm(1) program,
  1399.               enabling a term function status line if the X numeric parameter
  1400.               allows.
  1401.  
  1402.               SEE ALSO: X numeric parameter The LINES and COLUMNS environment
  1403.               variables preset the # and $ numeric parameters respectively.
  1404.               This assumption may be overridden by setting the X numeric
  1405.               parameter.
  1406.  
  1407.               If the TERM environment parameter contains the string 401
  1408.               indicating emulation of a Tektronix 4010 series storage tube
  1409.               terminal, status line updates are inhibited when Tek graphics is
  1410.               active.
  1411.  
  1412.               If the TERM environment parameter begins with "wy" (as in
  1413.  
  1414.  
  1415.         (C) 1990 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1416.  
  1417.  
  1418.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1419.         ZCOMM User Manual                                                   85
  1420.  
  1421.               "wy60") ZCOMM will use and recognize Wyse escape sequences.  The
  1422.               TERM environment variable is also checked for AT386 which
  1423.               enables a different decoding of keyboard escape sequences.
  1424.  
  1425.         UUCPLOCK If UUCPLOCK contains "/usr/spool/locks/LCK.." ZCOMM uses
  1426.               "Honey Danber" uucp port arbitration conventions.
  1427.  
  1428.  
  1429.         16.3  Dialing in to Unix
  1430.  
  1431.         Unix flavors may be used for dial-in applications to transfer files
  1432.         and commands with programs logged in to terminal ports.  The commands
  1433.         rz, sz, zcommand, and zcommandi perform the same functions as the
  1434.         corresponding ZCOMM commands.  They may be given directly to the shell
  1435.         or executed from a shell script or Makefile.
  1436.  
  1437.         EXAMPLE: sz -Yn *.c *.h
  1438.  
  1439.  
  1440.         The Makefile fragment below commands a DOS ZCOMM logged into a serial
  1441.         port to clear its dirrx string parameter, change to its root
  1442.         directory, and then sends a new version of the executable to the DOS
  1443.         machine.
  1444.  
  1445.         EXAMPLE: cpsz:/tmp/yam.exe
  1446.                         @zcommand 'set dirrx ""'
  1447.                         @zcommand "c:;cd /"
  1448.                         @sz -y /tmp/yam.exe
  1449.  
  1450.  
  1451.         More general command sequences or other protocols such as Kermit may
  1452.         be accessed with the xyam command.
  1453.  
  1454.         EXAMPLE: xyam kermit sb *.c *.h
  1455.  
  1456.  
  1457.         EXAMPLE: xyam z pl256 sz -Yn *.c *.h
  1458.  
  1459.  
  1460.         16.3.1  Initialized Logins  When a user logs in, the Unix shell
  1461.         executes commands in .profile in the user's home directory.  This can
  1462.         be used to accept file(s) from callers, send file(s), perform suitable
  1463.         processing, and log out the user automatically.
  1464.  
  1465.         The following .profile disables hangup and interrupt signals, then
  1466.         invokes xyam to execute commands in a script.
  1467.  
  1468.         set -e
  1469.         trap "" 1 2 3
  1470.         xyam source inbound.t
  1471.         exit
  1472.  
  1473.  
  1474.         (C) 1990 Omen Tech Inc                       Chapter 16 Running ZCOMM
  1475.  
  1476.  
  1477.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1478.         ZCOMM User Manual                                                   86
  1479.  
  1480.         The following inbound.t receives a file from a hand held aviation
  1481.         recorder.
  1482.  
  1483.                         echo "Send XMODEM file"
  1484.                         ena -d
  1485.                         rx -y airlink.tmp
  1486.                         if ? echo "File Received"
  1487.                         if !? echo "Sorry."
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.         (C) 1990 Omen Tech Inc                     Chapter 16 Commands Outline
  1534.  
  1535.  
  1536.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1537.         ZCOMM User Manual                                                   87
  1538.  
  1539.         17.  OUTLINE OF COMMANDS
  1540.  
  1541.  
  1542.  
  1543.         17.1  Setup
  1544.  
  1545.         port 1 ..........................Select the modem port
  1546.         portx hbase,vec .................Select non standard modem
  1547.         speed 1200 ......................Set the "baud rate"
  1548.         handshake {on|off|cts|dsr|dcd|both|slow}Hardware flow control
  1549.  
  1550.  
  1551.         17.2  Data Call
  1552.  
  1553.         queue............................Manipulate a dialing queue
  1554.         call [-N] system ................[N retries]
  1555.         234-5678 ........................Dial a local number
  1556.         234-5678/mnp ....................Dial a local number with MNP
  1557.         %l-503-621-3746 .................Dial long distance
  1558.         learn lfile .....................TurboLearn information to lfile
  1559.         xpc C ... .......................Enable and control virtual channels
  1560.         with X.PC
  1561.         bye .............................Disconnect current call
  1562.         off .............................Disconnect and exit
  1563.         String parameters: phones, mcommand, mprefix, msuffix, mconnect
  1564.  
  1565.  
  1566.         17.3  Interactive Operation
  1567.  
  1568.         F2, t [-modes] ..................Begin terminal conversation
  1569.         learn lfile .....................TurboLearn information to lfile
  1570.         conf ............................Online conference with edit window
  1571.         F8 ..............................Generate a password
  1572.         enable -modes ...................Modify term function characteristics
  1573.         set .............................Assigns a string or command to a
  1574.         function key
  1575.         String parameters break, bs, esc, etx, xpassword, entstr, lpnono
  1576.  
  1577.  
  1578.         17.4  Message Transfer Commands
  1579.  
  1580.                              Normal Interactive Transfers
  1581.         f [-modes] file .................Send file with the term function
  1582.         t [-modes] file .................Terminal conversation with capture to
  1583.         file
  1584.         kill ............................Erase the contents of the circular
  1585.         buffer
  1586.         w, ALT-W ........................Write the circular buffer
  1587.         close, ALT-C ....................Close the capture file
  1588.         Term Function Modes .............(capture/send modifiers)
  1589.         String parameters: eolstr, blankfill
  1590.  
  1591.  
  1592.         (C) 1990 Omen Tech Inc                     Chapter 17 Commands Outline
  1593.  
  1594.  
  1595.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1596.         ZCOMM User Manual                                                   88
  1597.  
  1598.                                 Special File Transfers
  1599.         fput ............................High Speed file dump to modem
  1600.         fpute ...........................Send file with Echoplex check
  1601.         fget ............................High speed modem to disk data dump
  1602.  
  1603.  
  1604.         17.5  Protocol File Transfer Commands
  1605.  
  1606.         F3, rb [-options] [dir] [file ...] Receive files with YMODEM or Clink
  1607.         rz [-options] [dir] [file ...] ..Receive files with ZMODEM
  1608.         kermit rb [-options] ............Receive files with Kermit
  1609.         rx [-options] rxfile ............Receive a file with XMODEM
  1610.         rt [-options] [dir] [file ...] ..Receive files with Telink/FIDO
  1611.         r7 [-options] [dir] [file ...] ..Receive files with MODEM7
  1612.         ro [-options] rxfile ............Receive a file with XMODEM
  1613.         OverThruster
  1614.         rw [-options] rxfile ............Receive a file with WXMODEM
  1615.         rc [-options] rxfile ............Receive a file with XMODEM/CRC
  1616.         sz [-options] txfile ... ........Send file(s) with ZMODEM
  1617.         sb [-options] txfile ... ........Send file(s) with YMODEM or Clink
  1618.         sx [-options] txfile ............Send a file with XMODEM or XMODEM/CRC
  1619.         st [-options] txfile ... ........Send file(s) with Telink/FIDO
  1620.         s7 [-options] txfile ... ........Send file(s) with MODEM7
  1621.         zcommand COMMAND ................Remote COMMAND with ZMODEM
  1622.         !!COMMAND........................Remote COMMAND with Kermit or ZMODEM
  1623.         kermit sb [-options] txfile ... .Send file(s) with Kermit
  1624.         Kermit Server Access Commands
  1625.         AUTOMATIC File Transfers.........(Compuserve-B, Kermit, ZMODEM)
  1626.         String parameters adlopts
  1627.         Options for Protocol File Transfers
  1628.         Numeric Parameters for XMODEM/YMODEM/ZMODEM Transfers
  1629.         Special Keys for Protocol Transfers
  1630.  
  1631.         17.6  Macro Commands
  1632.  
  1633.         call system .....................Execute telephone directory entry
  1634.         r [oldcmd] ......................Reenter previous command
  1635.         Up, Down ........................Select previous commands for reentry
  1636.         source scriptfile ...............Call subroutine
  1637.         set .............................Assign a string or command to a
  1638.         function key
  1639.         keys ............................Display soft key definitions
  1640.         reskeys .........................Clear soft key definitions
  1641.         SOFT KEYS .......................Transmit strings or execute commands.
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.         (C) 1990 Omen Tech Inc                     Chapter 17 Commands Outline
  1652.  
  1653.  
  1654.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1655.         ZCOMM User Manual                                                   89
  1656.  
  1657.         17.7  Display Commands / Terminal Emulation
  1658.  
  1659.         display displaymodes ............Set CRT parameters, screen emulation
  1660.         cl, cls .........................Clear the Screen
  1661.         mk...............................Map keys for terminal emulation
  1662.         videobios N .....................Set video BIOS mode N (for 132 cols)
  1663.  
  1664.  
  1665.         17.8  Disk/File Access Commands
  1666.  
  1667.         a: ..............................Change default disk
  1668.         ap file1 file2 ..................Append file1 to file2
  1669.         apd file1 file2 .................Append file1 to file2, delete file1
  1670.         cd directory ....................Change directory
  1671.         cdd D:dir .......................Change disk and directory
  1672.         dir[rlstx] ......................Sorted directory listings
  1673.         !DOS-command ....................DOS Gateway to another program
  1674.         browse file .....................Browse a set of files
  1675.         crc file ... ....................Display 32 bit file CRC's
  1676.         del file ........................Delete files from disk
  1677.         dump file ... ...................Side by Side HEX/ASCII file dump
  1678.         egrep regular-expression file ... Pattern matching file searching
  1679.         egrepq regular-expression file ... String extraction
  1680.         find string file ... ............Case insensitive file searching
  1681.         findq string file ... ...........String extraction
  1682.         list file ... ...................File list on DOS standard output
  1683.         page file ... ...................Pauses after each screenful
  1684.         read file .......................Fill circular buffer from open file
  1685.         seek [-]offset ..................Seek to location in file
  1686.         Home, End, PgUp .................Enter review function
  1687.         sum file ... ....................Display Unix style file checksum
  1688.         usq file ... ....................Unequeeze, [decrypt] files
  1689.         wc file ... .....................File character, word, line count
  1690.         <file ...........................Simulate keyboard input from file
  1691.         >outfile ........................Redirect utility command output
  1692.  
  1693.  
  1694.         17.9  Remote Takeover / Control
  1695.  
  1696.         host ............................Enter Host Operation
  1697.         link ............................Connect to another computer
  1698.         message .........................Leave a public message
  1699.         private .........................Leave a private message
  1700.         remote ..........................Accept remote commands
  1701.         unrestrict.......................Allow caller unrestricted access
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.         (C) 1990 Omen Tech Inc                     Chapter 17 Commands Outline
  1711.  
  1712.  
  1713.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1714.         ZCOMM User Manual                                                   90
  1715.  
  1716.         17.10  Support Commands
  1717.  
  1718.         bdump file ......................Dump interrupt input buffer to file
  1719.         display displaymodes ............List or change CRT operation
  1720.         enable -mode[s]..................Modify term function operation
  1721.         exit ............................Exit to DOS
  1722.         help ............................Activate help database
  1723.         kbdlock on|off ..................Lock/Unlock keyboard
  1724.         kbdmon [file] ...................Monitor keystrokes in file
  1725.         p ...............................Set/display numeric parameters
  1726.         reset............................Reset display and disk system
  1727.         set .............................Set string parameters / soft keys
  1728.  
  1729.  
  1730.         17.11  Record Keeping Commands
  1731.  
  1732.         nolog ...........................Inhibit next log entry
  1733.         timestamp .......................Display/write time and other info
  1734.         restime .........................Reset elapsed time counter to 0
  1735.         String parameters: calllog, txlog, rxlog, plog, rxcnt
  1736.  
  1737.  
  1738.         17.12  Script Commands
  1739.  
  1740.         abort ...........................Returns to command prompt
  1741.         accept ..........................Read keyboard response to string
  1742.         variable
  1743.         bg...............................Indicate background operation
  1744.         createx file ....................Exclusive file creation (for
  1745.         semaphores)
  1746.         echo ............................Display message
  1747.         fg...............................Indicate foreground operation
  1748.         kill [-signum] procnum ..........Interprocess communications
  1749.         lput string .....................Local screen write
  1750.         lputp string ....................Output string to printer
  1751.         expand script pathspec ..........Execute script for each file in
  1752.         pathspec
  1753.         fail ............................Failure return from script
  1754.         gosub name[.file] ...............Script subroutine call
  1755.         goto ............................Branch to label in same script.
  1756.         grab svar .......................Read line from file to string
  1757.         variable
  1758.         if, else.........................Execute rest of line conditionally
  1759.         kbdlock on|off ..................Lock/Unlock keyboard
  1760.         ki ..............................Reset capture buffer search area
  1761.         on ..............................Conditional execution, tested after
  1762.         each command
  1763.         pattern .........................Specify string searches in modem data
  1764.         purge{k|l} ......................Purge typeahead or modem input buffer
  1765.         put[v] ..........................Send string [variable] to modem
  1766.         return...........................Return to previous script level
  1767.  
  1768.  
  1769.         (C) 1990 Omen Tech Inc                     Chapter 17 Commands Outline
  1770.  
  1771.